home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-13
/
zap104.zip
/
ZAP.DOC
< prev
next >
Wrap
Text File
|
1991-04-30
|
41KB
|
962 lines
Z A P v.1.04
Binary File Editor
P L U S
a program development and debugging tool
a data file maintenance tool
April 20, 1991
1 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
TABLE OF CONTENTS This document contains the following:
TABLE OF CONTENTS ....................... 1
ZAP PROGRAM DESCRIPTION ................. 2
General Features
Some Assumptions
COMMAND MODE ............................ 3
Overview
Cursor Keys
Commands
Ascii Chart Command ................... 4
Capture Block Command
Dos Shell Command
Edit Block Command
Help Command Command
Load File Command ..................... 5
- Load File Options
- Auto Load Option
Memory Dump Command
Next Search Command
Print Block Command ................... 6
- Print Block Options
Quit Command Command
Search Ascii Command .................. 7
Search Hex Command
Zap Stats Command
EDIT MODE ............................... 8
Overview
Cursor Keys
Commands
Ascii Chart Command ................... 9
Data Conversion Command
Filter Ascii Command
Help Edit Command
Quit Edit Command ..................... 10
View Capture Command
RANDOM NOTES ............................ 11
Data Entry Keys
Video Information
ZAP Updates
ZAPCOLOR ................................ 12
ZAP Custom Colors
ZAP Default Colors
NOTICES ................................. 13
Shareware
Registration
Disclaimer
Copyright
INVOICE ................................. 14
ADDENDUM ................................ 15
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 1
2 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
ZAP PROGRAM DESCRIPTION ZAP is a file editor for binary and other
program and data files. Plus, ZAP can
examine and modify computer memory.
General Features ZAP works with files up to 16 megabytes
minus 512 bytes.
ZAP will open a specified file and read a
single 256 byte block of data into memory.
Once in memory, a block can be edited in
Ascii and hexadecimal modes. A modified
block can be saved back to the file.
ZAP can read but can not edit a file that
is flagged by Dos as 'read only'.
ZAP can not (will not) extend a file by
writing back more bytes than were read.
ZAP works with computer memory up to one
megabyte.
Memory blocks of 256 bytes can be edited
and saved back to memory (RAM).
ZAP can read but can not write to ROM.
ZAP is programmed in Turbo C 2.0, small
memory model for speed, and incorporates
numerous 8086 assembly language functions
in critical sections for even more speed.
ZAP was developed on a 286/VGA system and
requires Dos 2.00 plus and 128K of RAM.
Some Assumptions You are reading the documentation for a
program which is designed primarily as a
program and data file maintenance tool.
Assumption: you are a programmer or you
are someone who maintains many or large
data files. To use ZAP effectively, you
need a good understanding of Ascii codes
and the hexadecimal numbering system.
If so, ZAP and the remainder of this
brief document is written for you.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 2
3 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
COMMAND MODE ZAP starts in this mode.
Overview Everything that you can do with ZAP is done
from the command mode.
Cursor Keys While you are in command mode, you can view
memory up to one megabyte, or you can load
and view the contents of a file. Viewing
is accomplished by the following keys:
UP/DOWN arrows display the previous or
the next block.
PGUP/PGDN keys display the previous or
the next 16 blocks (4K).
HOME/END keys display the first or the
last block.
Commands Command mode is 'commanded' by a small
command language, as follows:
A ASCII CHART displays an Ascii chart.
C CAPTURE BLOCK captures the current
block to a memory buffer.
D DOS SHELL executes a Dos command
shell.
E EDIT BLOCK enters edit mode to edit
the current block.
H/F1 HELP COMMAND displays command mode
quick reference help.
L LOAD FILE displays a file listing
for the current directory.
M MEMORY DUMP initializes ZAP for
viewing and editing memory;
this is the start up default.
N NEXT SEARCH continues an active
search using the last specified
text or data.
P PRINT BLOCK prints a specified
block range to Dos's PRN.
Q/ESC QUIT COMMAND exits to Dos.
SA SEARCH ASCII initiates a search for
specified Ascii text.
SH SEARCH HEX initiates a search for
specified hexadecimal data.
Z ZAP STATS displays current statistics
for ZAP.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 3
4 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
COMMAND MODE continued
Ascii Chart Command [A] ASCII CHART command displays an Ascii
chart. The complete chart is 32 lines long
with 16 lines on display. The Ascii codes
0x00 to 0x7F are displayed on the first 16
lines. Codes 0x80 to 0xFF are displayed on
the next 16 lines.
The chart can be scrolled via the cursor
keys described above. Press the ESC key
to return to command mode.
Capture Block Command [C] CAPTURE BLOCK command captures the
block currently on display to a memory
buffer. The captured block can be viewed
while edit mode is active, providing you
with a quick reference 'memo' to another
area of memory or a file.
Dos Shell Command [D] DOS SHELL command executes a Dos command
shell. You can perform any Dos function you
wish while at Dos, except load a TSR.
If you change the drive or directory while
at Dos, then ZAP will restore these when
you return. ZAP can change directories
via the [L] LOAD FILE command.
Edit Block Command [E] EDIT BLOCK command enters edit mode to
allow you to edit the current block. ZAP
will not enter edit mode if the current
file is flagged by Dos as 'read only'.
Detailed information on ZAP's edit mode
can be found elsewhere in this document.
Help Command Command [H][F1] HELP COMMAND command displays
command mode quick reference help.
Brief descriptions for command mode command
language and the cursor keys are given.
The help window can be scrolled via the
cursor keys described above. Press the
ESC key to return to command mode.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 4
5 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
COMMAND MODE continued
Load File Command [L] LOAD FILE command displays a file
listing for the current directory.
The file window can be scrolled via the
cursor keys described above. Press the
ESC key to return to command mode.
- Load File Options To select a file or a directory, move the
highlight bar to the filespec and press the
ENTER key.
If you have selected a program or a data
file, then it will be loaded into ZAP.
If you have selected a directory, then
ZAP will change to the selected directory
and generate a new file listing.
- Auto Load Option ZAP will accept a filespec on the command
line at start up, for example:
ZAP c:\tc\myprog.exe
The Dos directory wildcard character (.)
is OK in the path portion of the filespec
only; ZAP can not load (*) filespecs.
Memory Dump Command [M] MEMORY DUMP command initializes ZAP
to the start up condition of viewing and
editing memory. If a file is loaded, then
it will be unloaded. If no file is loaded,
then you are already viewing memory and
this command will have no effect.
Next Search Command [N] NEXT SEARCH command continues an active
search using the text or data specified for
the last Ascii or hexadecimal search.
The search continues from the current block
to the end of memory or the file.
One of ZAP's two searches must have been
previously initialized.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 5
6 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
COMMAND MODE continued
Print Block Command [P] PRINT BLOCK command prints a specified
block range to Dos's PRN device. Printed
output is formatted for 8 1/2 by 11 inch
continuous forms. Three blocks are printed
on each page. Form feeds (0x0C) are used.
Printing is sent to the standard print
device so that printed output can be re-
directed via Dos or other software. ZAP
does not provide a print to file or other
device option.
- Print Block Options The current block, a single specified
block, a specified block range, BOM/BOF
to a specified block, a specified block
to EOM/EOF, and BOM/BOF to EOM/EOF ranges
can be printed.
To generate reports for the above ranges
in the sequence given, specify:
current block
100 a single specified block
100-200 a specified block range
-100 BOM/BOF to a specified block
200- a specified block to EOM/EOF
1- BOM/BOF to EOM/EOF
All block references are given in decimal
(base 10) starting from block number 1.
Press the ESC key to cancel a report in
progress. ZAP will print a cancellation
message at the point of interruption.
If allowed to run to completion, then ZAP
will print a report status showing the
block range reported and the total number
of blocks in memory or in the file.
Quit Command Command [Q][ESC] QUIT COMMAND command exits from
ZAP and returns you to Dos, or to where
you came from (Dos is assumed). ZAP saves
the video screen at entry and restores it
when you exit.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 6
7 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
COMMAND MODE continued
Search Ascii Command [SA] SEARCH ASCII command initiates a search
for specified Ascii text. The search starts
at the beginning of memory or the file and
proceeds to the end of memory or the file.
When you specify the text to search for, you
should be aware that this search is case
sensitive. Also, any leading and trailing
blank spaces will be removed.
If the specified text is found, then the
block containing the matching text will be
displayed. The first character of the
specified text will flash on the screen.
If you enter edit mode while a flashing
character is on the screen, then the cursor
will locate at that character.
To continue a search using the specified
text, use the [N] NEXT SEARCH command.
Search Hex Command [SH] SEARCH HEX command initiates a search
for specified hexadecimal data. The search
proceeds from beginning to end of memory or
the file.
Like the [SA] SEARCH ASCII command, this
search is case sensitive. Unlike [SA],
leading and trailing blank spaces are not
automatically removed.
Hexadecimal data is entered as follows:
20 4E 65 61 75 00 0A
Two hexadecimal digits are required for
each byte. The single blank space between
byte entries is required.
To continue a search using the specified
data, use the [N] NEXT SEARCH command.
Zap Stats Command [Z] ZAP STATS command displays current
statistics for ZAP. Press the ESC key
to return to command mode.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 7
8 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
EDIT MODE This is what ZAP is all about.
Overview Everything that you can do to data blocks
is done in the edit mode.
While you are in edit mode you can edit the
information in the current block only.
As information is modified the changes are
visually highlighted. Changing information
back to its original value will remove the
highlighting.
If any information is changed when you exit
from edit mode, [aQ][ESC] QUIT EDIT command,
then you will be prompted to save the changes
back to memory or the file. Answer the save
prompt Y for yes to save changes or N for no
to abandon changes.
Cursor Keys You can move around the block and between
Ascii and hexadecimal edit modes via the
following keys:
TAB key moves the cursor between Ascii
and hexadecimal edit modes.
UP/DOWN arrows move the cursor to the
previous or next line.
LEFT/RIGHT arrows move the cursor to the
previous or next character.
Commands Edit mode is 'commanded' by a tiny command
language, as follows:
aA ASCII CHART displays an Ascii chart.
aD DATA CONVERSION displays the four
bytes starting at the cursor as
various integer data values.
aF FILTER ASCII toggles an Ascii filter
on the current block.
aH/F1 HELP EDIT displays edit mode quick
reference help.
aQ/ESC QUIT EDIT exits to command mode.
aV VIEW CAPTURE displays a previously
captured block.
The lowercase 'a' preceding each of these
commands indicates use of the ALT key.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 8
9 ////////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
EDIT MODE continued
Ascii Chart Command [aA] ASCII CHART command displays an Ascii
chart. The complete chart is 32 lines long
with 16 lines on display. The Ascii codes
0x00 to 0x7F are displayed on the first 16
lines. Codes 0x80 to 0xFF are displayed on
the next 16 lines.
The chart can be scrolled via the cursor
keys described in the COMMAND MODE section
above. Press the ESC key to return to
edit mode.
Data Conversion Command [aD] DATA CONVERSION command displays the
four bytes starting at the cursor as char,
int and long, signed and unsigned, and as
unsigned binary data values.
The binary bit map is generated as per the
Intel iAPX convention, from right to left;
LSB at right represents the byte that the
cursor is on, the next MSB represents the
the byte following the cursor, etc., to
four bytes, 32 bits, total.
Press the ESC key to return to edit mode.
Filter Ascii Command [aF] FILTER ASCII command toggles an Ascii
filter on the current block. When OFF, all
codes (0x00 to 0xFF) are shown in the Ascii
display. When ON, only display codes from
0x20 to 0x7E are shown. The Ascii filter
is active only while edit mode is active.
Help Edit Command [aH][F1] HELP EDIT command displays edit
mode quick reference help.
Brief descriptions for edit mode command
language and the cursor keys are given.
The help window can be scrolled via the
cursor keys described in the COMMAND MODE
section above. Press the ESC key to
return to edit mode.
ZAP Binary File Editor v.1.04 ///////////////////////////////////////// 9
10 ///////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
EDIT MODE continued
Quit Edit Command [aQ][ESC] QUIT EDIT command exits from edit
mode and returns you to command mode.
If any information in the current block is
changed when you exit from edit mode, then
you will be prompted to save the changes
back to memory or the file. Answer the
save prompt Y for yes to save changes or
N for no to abandon changes.
View Capture Command [aV] VIEW CAPTURE command displays a
previously captured block.
While command mode is active you can cap-
ture the block currently on display to a
memory buffer, [C] CAPTURE BLOCK command.
Later, while edit mode is active and you
are editing a different block, presumably,
you can view the captured block with the
[aV] VIEW CAPTURE command.
This command provides you with a quick
reference to another area of memory or
a file.
Press the ESC key to return to edit mode.
ZAP Binary File Editor v.1.04 //////////////////////////////////////// 10
11 ///////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
RANDOM NOTES Things that didn't fit in elsewhere.
Data Entry Keys When you specify options for the [P] PRINT
BLOCK command, or for the [SA] SEARCH ASCII
and [SH] SEARCH HEX commands, the following
data entry keys are available:
LEFT/RIGHT arrows move the cursor to the
previous or next character.
INS/DEL keys insert or delete a character
at the cursor position.
BACKSPACE key erases the character to the
left of the cursor position.
ENTER key completes your data entry.
Video Information ZAP will look at the video mode at start
up and configure itself appropriately.
Irrespective of video mode, ZAP performs
all video writes direct to video memory.
No special allowance is made for CGA snow
problems.
ZAP has a built-in 'screen saver' that will
automatically kick in after two minutes of
no activity at the keyboard. A travelling
'heartbeat' will replace the current screen.
To restore your screen, touch any key.
ZAP Updates ZAP v.1.04 corrects a few programming bugs
in the ZAP.EXE and ZAPCOLOR.EXE programs.
ZAP v.1.04 is complete for my purposes.
I have no plans at this time to further
update the program unless a bug crops up.
Having said that, I hasten to add; prove
me wrong! If there is real interest in
(i.e., registration of) ZAP, then I am
willing to consider updates incorporating
features and options that you may request.
Yours truly,
Ted Warnell,
Neau Systems Software
ZAP Binary File Editor v.1.04 //////////////////////////////////////// 11
12 ///////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
ZAPCOLOR A program named ZAPCOLOR.EXE is included
in the ZAP104.ZIP file. ZAPCOLOR is used
to customize ZAP's color table.
ZAP Custom Colors To customize ZAP's color table:
Start ZAPCOLOR from Dos.
Use the cursor keys to move the highlight
bar through the item select window at left.
Press the ENTER key to select an item.
Type a color code from the color select
window at the bottom of the screen and
press the ENTER key.
Your color selection will be displayed in
the ZAP sample window at upper right.
ZAPCOLOR will run only if:
1 The video mode at start up is a color
text mode, mode 1 or 3.
2 ZAP.EXE is in the current directory.
ZAPCOLOR can not change color mono mode
and monochrome system default colors.
ZAP Default Colors ZAP's color system defaults:
Item Code Color
top line> 015 WHITE on BLACK
head/foot bar> 007 LIGHTGRAY on BLACK
head/foot> 120 DARKGRAY on LIGHTGRAY
data screen> 007 LIGHTGRAY on BLACK
modified data> 015 WHITE on BLACK
edit cursor> 079 WHITE on RED
command bar> 007 LIGHTGRAY on BLACK
command line> 112 BLACK on LIGHTGRAY
bottom line> 007 LIGHTGRAY on BLACK
pop ups> 095 WHITE on MAGENTA
ascii/help> 007 LIGHTGRAY on BLACK
The [L] LOAD FILE command pop up window
highlight bar is always WHITE on BLACK.
ZAP Binary File Editor v.1.04 //////////////////////////////////////// 12
13 ///////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
NOTICES Things that need to be said.
Shareware User supported software is a concept started by Andrew
Fluegleman. Software is distributed to the user without
cost. You are allowed to evaluate this product on your
own system on a trial basis. If you find this product
to be of value and intend to continue using it, then you
are asked to register your copy and pay the license fee.
You are encouraged to copy and share this product with
other users provided that you abide by the following
rules and limitations:
1 The programs and documentation are distributed in
whole and in their original, not modified form.
2 No fee, charge, or other consideration is charged
for distribution of this product.
3 This product is not distributed as part of any other
package without written authorization.
Registration If you intend to add ZAP to your library, please support
the author through your registration. Commercial and/or
business use of ZAP by non-registered users is prohibited.
ZAP v.1.04 Single License Fee is only .......... $ 16.00
Disclaimer ZAP is provided "AS IS" without warranty of any kind,
including, but not limited to, the implied warranties
of merchantability and fitness for a particular purpose.
Neither the author nor Neau Systems Software shall be
liable for any errors or omissions contained herein,
or for any incidental or consequential damages arising
from the use of this product.
IT IS GOOD DATA PROCESSING PRACTICE TO FREQUENTLY BACKUP
YOUR IMPORTANT DATA AND CAREFULLY TEST ANY NEW SOFTWARE
ON YOUR SYSTEM TO INSURE PROPER OPERATION.
Copyright ZAP Binary File Editor program, ZAPCOLOR Color Setup
Utility program, and this printed documentation are
copyrighted (c) 1991 by Neau Systems Software and by
Mr. Ted Warnell, Canada. ALL RIGHTS ARE RESERVED.
ZAP Binary File Editor v.1.04 //////////////////////////////////////// 13
14 ///////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
INVOICE Payment of this invoice entitles you to use
ZAP software on a single computer system.
Write to the address below for site license
information.
- cut here - - - - - - - - - - - - - - - - - - - - - - - - - - - cut here -
Neau Systems Software (403) 244-7395
2511 15A Street SW
Calgary, Alberta, Canada
T2T 4B8
Date __________________ I N V O I C E NSS #910420-01
GST R128642147
Sold to ............... _______________________________________
Product ............... ZAP Binary File Editor v.1.04 computer
application software.
Price ............................................. $ 14.96
GST (tax) ......................................... $ 1.04
___________
Total ............................................. $ 16.00
Please make your check or money order payable to:
NEAU SYSTEMS SOFTWARE
Retain this invoice for your tax or other records.
Comments, critiques and suggestions regarding ZAP
can be forwarded to the above address.
- cut here - - - - - - - - - - - - - - - - - - - - - - - - - - - cut here -
ZAP Binary File Editor v.1.04 //////////////////////////////////////// 14
15 ///////////////////////// ZAP Binary File Editor PROGRAM DOCUMENTATION
ADDENDUM A suggestion for configuring ZAP's default
color table.
April 20, 1991
ZAP's default color table for color systems
is pretty toned down. Some of you really
serious programmer types will undoubtedly
appreciate this 'basic black' approach.
For those of you who would like a little
more pizazz, here is my personal favorite
color scheme; I call it, RGB Supreme:
Item Code Color
top line> 015 WHITE on BLACK
head/foot bar> 002 GREEN on BLACK
head/foot> 047 WHITE on GREEN
data screen> 027 LIGHTCYAN on BLUE
modified data> 030 YELLOW on BLUE
edit cursor> 079 WHITE on RED
command bar> 004 RED on BLACK
command line> 079 WHITE on RED
bottom line> 011 LIGHTCYAN on BLACK
pop ups> 127 WHITE on LIGHTGRAY
ascii/help> 011 LIGHTCYAN on BLACK
Check it out. You will find this setup is
attractive, has high visual impact, and is
very communicative.
Yours,
Ted
ZAP Binary File Editor v.1.04 //////////////////////////////////////// 15